User Commands 



DINEROIV ( 1 ) 



NAME 



dineroIV - fourth generation cache Simulator 



SYNOPSIS 

dineroIV [options] 

DESCRIPTION 

The dineroIV command is a trace-driven cache Simulator based on the dineroIV library, documented sepa- 
rately. 

The basic operation is to read memory reference trace records from the standard input, process them 
through one or more simulated caches forming a memory hierarchy, and write statistics on the standard out- 
put. 

OPTIONS 

Some options control overall operation, while others specify the basic parameters and arrangement of the 
caches to be simulated. In the following list of options, F is a string, U is an unsigned decimal integer, C is 
a single character, A is a hexadecimal address, and S is like U, but with an optional scaling suffix character 
(one of kKmMgG, for multiplication by 0x400, 0x100000, or 0x40000000). P is like S, but must be a 
power of 2, N is a cache levei (1 < N), where levei 1 is closest to the processor, and T is a cache type 
(u=unified, i=instruction, d=data). 

Some global options take or 1 argument, while options that specify characteristics of a particular cache 
typically involve 2 or 3 arguments, with the cache levei and type being incorporated into the option name as 
indicated. 



-help 

-copyright 

-contact 

-dineroIII 
-custom F 



-skipcount U 
-flushcount U 
-maxcount U 
-stat-interval U 

-informat C 



-on-trigger A 
-off-trigger A 
-stat-idcombine 
-W-Tbsize P 



Print a synopsis of ali the options and defaults. No simulation is done. 

Describe copyright terms for dineroIV. 

Tell how to get the latest version of Dinero IV and how to contact the authors. This 
information is also available below, in AUTHORS and COPYRIGHT. 

Show what dineroIV command line arguments corespond to each dineroIII argument. 

Generate and run a customized version of the Simulator, with the resulting executable 
named F. Most cache parameters are fixed and made into constants, with a resulting 
performance boost that is somewhat variable, but generally recommended for lengthy 
simulations. The fixed options are unsettable in the customized program; run F with 
the -help option to see exactly which options are still available. F is not removed 
following simulation, so it can be used for more than one run. The dineroIV source 
code must be available and properly configured for -custom to work, with the 
D4_SRC environment variable naming the directory. 

Disregard the initial U memory references from the standard input. 

Flush the cache after processing every U references read from the standard input. 

Stop the simulation after processing U references read from the standard input. 

Show statistics after processing every U references read from the standard input. 
This is in addition to the statistics produced at the end of the full simulation. 

Select the input trace format as indicated by C (D=extended din, d=traditional din, 
p=pixie32, P=pixie64, b=binary). The exact current list of choices is given by the 
-help option. The default input format is D. See TRACE RECORDS, below, for 
more information. 

Disregard trace records until one with address A is seen. 

Disregard trace records after seeing one with address A . 

Combine the statistics for separate instruction and data caches. 

Set the block size of the specified levei N cache to P bytes. 
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-W-rsbsize P Set the sub-block size of the specified levei N cache to P bytes. If not specified, sub- 

blocks are not used (i.e., sub-block size = block size). 

-W-rsize P Set the cache size of the specified levei N cache to P bytes. 

-W-rassoc U Set the associativity of the specified levei N cache to U . 

-W-7repl C Set the replacement policy of the specified levei N cache to C (1=LRU, f=FIFO, 

r=random). The exact current list of choices is given by the -help option. 

-W-rfetch C Set the fetch policy of the specified levei N cache to C (d=demand, a=always, 

m=miss, t=tagged, l=load forward, s=sub-block). The exact current list of choices is 
given by the -help option. Further information on fetch policies is given in 
dineroIV (3). 

-W-7pfdist U Set the prefetch distance of the specified levei N cache to U sub-blocks. The default 

is 1. This option is not valid for the d fetch policy, where no prefetching will hap- 
pen. 

-W-7pfabort U Set the prefetch abort percentage of the specified levei N cache to U (0-100). The 

default is 0. The specified percentage of prefetch requests will be randomly chosen 
to be aborted, i.e., not happen. This option is not valid for the d fetch policy, where 
no prefetching will happen. 

-W-7walloc C Set the write allocate policy of the specified levei N cache to C (a=always, n=never, 

f=nofetch). The exact current list of choices is given by the -help option. Further 
information on write allocate policies is given in dineroIV Ç>) . 

-W-rwback C Set the write back policy of the specified levei N cache to C (a=always, n=never, 

f=nofetch). The exact current list of choices is given by the -help option. Further 
information on write back policies is given in dineroIV (i) . 

—IN— Tece Compute Compulsory/Capacity/Confiict miss rates for the specified levei N cache. 

TRACE RECORDS 

A dineroIV trace record, as processed internally, consists of three things: an access type, an address, and a 
size. The following access types are supported: 

• Read. 

• Write. 

• Instruction fetch. 

• Miscellaneous. These references are treated like reads, but they never generate prefetches. 

• Copy-back dirty (sub-)block(s), with no invalidation implied. This affects the whole cache if the indi- 
cated size is 0. 

• Invalidate block(s), with no copy-back implied. This affects the whole cache if the indicated size is 0. 

There are no internai restrictions on what constitutes a valid address, except that the size of an address is 
platform-dependent (generally 32 bits or more). The size value of a trace record indicates the number of 
bytes affected. Dinero IV imposes no size or alignment restrictions on memory references; they may span 
multiple sub-blocks or blocks. 

The following input formats are supported by the -informat option: 

d The traditional "din" format of Dinero III. Two fields are examined per line: access type and address. 
The access type is numeric: for read, 1 for write, 2 for instruction fetch, 3 for miscellaneous, 4 for 
copy-back, and 5 for invalidate. The address is hexadecimal, beginning with an optional "Ox" or 
"0X". Fields are separated by white space (space or tab), and everything following the first two fields 
of a line is ignored. To approximate the behavior of Dinero III, addresses are silently rounded down to 
a multiple of 4 bytes, and the data size for reads and writes is always assumed to be 4 bytes. 
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D An extended version of the traditional Dinero III input format, where each line contains three signifi- 
cant fields. The first field, specifying the access type, is a single letter (rwimcv) to indicate one of the 
access types described above. The second field is the hexadecimal address, and the third field is the 
hexadecimal size. A leading "Ox" or "OX" is ignored at the beginning of each hexadecimal field. 
Fields are separated by white space (space or tab), and everything following the first three fields of a 
line is ignored. 

p The format produced by pixie -idtrace on SGI IRIX systems. 

P The format produced by pixie -idtrace_ext on SGI IRIX systems. 

b A binary format, consisting of a four byte little-endian address, a 2-byte little-endian size, a 1-byte 
access type, and a byte of padding. 



FILES 



For the -custom option, the location of the Dinero IV source files is given by the D4_SRC environment 
variable. 

SEE ALSO 

dineroIV (3). 

AUTHOR 

Jan Edler and Mark D. Hill (edler@research.nj.nec.com and markhill@cs.wisc.edu, respectively). 

The latest version of Dinero IV can be obtained from 

ftp://ftp.nj.nec.com/pub/edler/d4-X.tgz 

where X is the latest version number. 

COPYRIGHT 

Copyright (C) 1997 NEC Research Institute, Inc. and Mark D. Hill. 

AU rights reserved. 

Copyright (C) 1985, 1989 Mark D. Hill. Ali rights reserved. 

Permission to use, copy, modify, and distribute this software and its associated documentation for non-com- 
mercial purposes is hereby granted (for commercial purposes see below), provided that the above copyright 
notice appears in ali copies, derivative works or modified versions of the software and any portions thereof, 
and that both the copyright notice and this permission notice appear in the documentation. NEC Research 
Institute Inc. and Mark D. Hill shall be given a copy of any such derivative work or modified version of the 
software and NEC Research Institute Inc. and any of its affiliated companies (collectively referred to as 
NECI) and Mark D. Hill shall be granted permission to use, copy, modify, and distribute the software for 
internai use and research. The name of NEC Research Institute Inc. and its affiliated companies shall not 
be used in advertising or publicity related to the distribution of the software, without the prior written con- 
sent of NECI. Ali copies, derivative works, or modified versions of the software shall be exported or reex- 
ported in accordance with applicable laws and regulations relating to export control. This software is 
experimental. NECI and Mark D. Hill make no representations regarding the suitability of this software for 
any purpose and neither NECI nor Mark D. Hill will support the software. 

Use of this software for commercial purposes is also possible, but only if, in addition to the above require- 
ments for non-commercial use, written permission for such use is obtained by the commercial user from 
NECI or Mark D. Hill prior to the fabrication and distribution of the software. 

THE SOFTWARE IS PROVIDED AS IS. NECI AND MARK D. HILL DO NOT MAKE ANY WAR- 
RANTEES EITHER EXPRESS OR IMPLIED WITH REGARD TO THE SOFTWARE. NECI AND 
MARK D. HILL ALSO DISCLADVI ANY WARRANTY THAT THE SOFTWARE IS FREE OF 
INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHTS OF OTHERS. NO OTHER 
LICENSE EXPRESS OR IMPLIED IS HEREBY GRANTED. NECI AND MARK D. HILL SHALL 
NOT BE LIABLE FOR ANY DAMAGES, INCLUDING GENERAL, SPECIAL, INCIDENTAL, OR 
CONSEQUENTIAL DAMAGES, ARISING OUT OF THE USE OR INABILITY TO USE THE SOFT- 
WARE. 
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